Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 7 - Finder Interface Reference / Finder Interface Functions

Routing Files /

FindFolderRouting

NEW WITH MAC OS 8

Finds the destination folder from a matching folder routing structure for the specified file.

pascal OSErr FindFolderRouting (
                     OSType fileType,
                     FolderType routeFromFolder,
                     FolderType *routeToFolder,
                     RoutingFlags *flags);

fileType

The file type specified in the appropriate folder routing structure for the file for which you wish to find a destination folder.

routeFromFolder

The folder type of the "from" folder for which you wish to find a "to" folder. An item dropped on the folder specified in this parameter will be routed to the folder specified in the routeToFolder parameter.

routeToFolder On output, a pointer to the folder type of the destination folder.

flags

Pass a pointer to a variable to contain the output produced by the flags parameter, or nil for no response. Because no routing flags are currently defined, 0 will be returned in this parameter. The flags field of the folder routing structure is reserved for future use by Apple Computer, Inc.

function result

A result code; see "Result Codes".

DISCUSSION

Both the file type and the folder type specified must match those of a folder routing structure in the global routing list for the FindFolderRouting function to succeed.

SPECIAL CONSIDERATIONS

The system initializes the Folder Manager's routing tables with a resource of type 'nrt#' located in the System file. You should not modify or rely on the contents of the 'nrt#' resource in the System file; use only the FindFolderRouting function to find the appropriate folder routing information.

Finder does not currently honor changes to the global folder routing list. Descriptions of some folder routing features are provided at this time for informational purposes only.